home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mgr / vdimgr.zoo / contrib / mgrterm / README < prev   
Encoding:
Text File  |  1993-03-16  |  6.9 KB  |  174 lines
  1.             mgrterm $Revision: 1.1 $
  2.  
  3.              jwahar r. bammi
  4.             bammi@cadence.com
  5.  
  6. mgrterm is a fairly full featured terminal emulator for use under MiNT or
  7. MiNT + MGR. when operating under MGR (default unless TERM is set to
  8. something other than "mgr") it will put up menus, accessible via the
  9. middle mouse button (left button if you use eric smiths mouse map in
  10. your ~/mgr.rc). if mgrterm is not operating under MGR, all the features
  11. are still available via a keyboard interface, accessible via the escape
  12. character CTRL-]. hit CTRL-]? to get the top level selection an follow the
  13. prompts from thereon down. the keyboard CTRL-] interface is also available
  14. when operating under MGR, but the verbose prompts are shut off. the rest
  15. of this file talks about mgrterm assuming you are operating under MGR, but
  16. keep in mind that all the features are available via the keyboard CTRL-]
  17. interface too.
  18.  
  19. USAGE:
  20.     mgrterm [-P <serial device>] [<white pages file>]
  21.  
  22. support for <serial device> is not in place, as i dont have an atariST capable
  23. of multiple serial devices. at a later stage i may add support for midi too.
  24.  
  25. the <whitepages> file may optionally be specified on the command line. if
  26. it is accessible for reading, it will be used. if it is not specified, mgrterm
  27. will first look for the environment variable WHITEPAGES. if it is not
  28. found it will look for d:\etc\white. if found, it will be used. see the
  29. section WHITEPAGES below for format of the whitepages file.
  30.  
  31. MENUS
  32. once mgrterm begins, the following menus are available on the middle button:
  33.  
  34.      Main Menu        Baud    Dial    FlowControl
  35.      ---------         ----    ----    -----------
  36.      Suspend        19200   ph#1    None
  37.      Baud =>         9600    ..     Rts/Cts
  38.      Dial =>         2400        Xon/Xoff
  39.      ToggleDuplex     1200    ..    Both
  40.      FlowControl =>      300   ph#n
  41.      StuffTermcap                ||
  42.      Shell                       \/
  43.      Status             paged 15 entries per page
  44.      =============
  45.      Quit
  46.  
  47. the menus marked "==>" are pull right menus (click on them and drag right
  48. for a submenu to appear). the dial submenus are paged 15 entries per page
  49. labeled with entries from your whitepages file. to dial a number, from
  50. the main menu pull-right on dial, then page down to the desired entry
  51. (dragging down the last entry on a submenu, will page you down to the
  52. next page if any). the rest of the menus do pretty much what you would
  53. expect them to do. suspend is particularly useful to fire up transfers
  54. with rz/sz. to use it, your shell must understand job control (bash, mintksh,
  55. allans improved init and the orig. mini-init all do).
  56.  
  57. WHITEPAGES:
  58.     the whitepages file may either be specified
  59.      - on the command line
  60.      - via the WHITEPAGES environment variable
  61.      - otherwise the default below is used if it exists
  62.      - if no white pages exits, the menu entry will contain a dummy.
  63.  The dial pull right menu is paged, 15 entries/page.
  64.  
  65.  The whitepages files can contain
  66.     - comments lines - beginning with '#'
  67.     - blank lines
  68.     - entries
  69.  a whitepages entry is for the form (max length of an entry == 132)
  70.  name : [baud] : [dial string]
  71.  
  72.  the name is the key. only enough characters to make the search
  73.  unambiguous need be specified. embedded blanks are significant.
  74.  leading and trailing one are ignored. case is significant.
  75.  
  76.  if no baud is specified, then the present baud rate is not changed,
  77.  otherwise the baud rate is set when the entry is chosen. leading and
  78.  trailing blanks are ignored. if the baud specified is invalid, the dial
  79.  is aborted.
  80.  
  81.  if a dial string is specified, it is sent to the modem with interpretation.
  82.  leading blanks are ignored. tailing ones are significant. the dial string
  83.  is interpreted as follows:
  84.    \n, \r, \\ send newline, carriage return and backslash respectively.
  85.    \nnn    send octal char nnn
  86.    \s<number> sleep for <number> seconds
  87.    \t<number> set char wait timeout to <number> seconds (default 10 seconds)
  88.    \w<char>   wait until char, all chars occurring in the mean while
  89.         are skipped. Abort dial on timeout. the char may be
  90.         specified in octal form \nnn (\r etc not allowed ).
  91.  examples:
  92.   unix direct login : 19200 : \w:bammi\r\w:mypasswd\r
  93.   # switch to 19200 baud, wait for ':' send string "bammi\r" wait for ':'
  94.   # send string "mypasswd\r". use default char wait timeout period.
  95.   unix dialup : 2400 : atdt5551212\w:bammi\r\w:mypasswd\r
  96.   compuserve : 2400 : atdt5551515\w2\w4\w0\w0\r\w:CIS\r\w:71515,111\r\w:xxx\r
  97.   timbaktu :: atdt1timbaktu\r
  98.   # use current baud rate
  99.   2400 : 2400 :
  100.   # just change baud rate
  101.   # here is my GEnie entry
  102. GEnie : 2400 : \t20atdt681-0501\r\w4\w0\w0\w\015\s1hhh\w=\022xtx12345,mypaswd\r
  103. what is does is:
  104.     - set char wait timeout to 20 seconds
  105.     - dial the genie #
  106.     - await 400[.*]\n    (from the modem saying "CONNECT 2400\r\n")
  107.     - sleep for 1 second
  108.     - send hhh
  109.     - wait for =    (from GEnie prompting U#= )
  110.     - send CTRL-R followed by the login string, followed by \r
  111.  
  112. MISC
  113. mgrterm is best run when the M_BACKGROUND mode is set on the window. mgrterm
  114. will set it on startup. (remember to definitely set this when doing rz/sz
  115. transfers, otherwise they will block and timeout, if the window is
  116. obscured). i do it in my ~/mgr.rc as follows:
  117.  
  118. map 0 4 1 5 2 6 3 7
  119. font 1   sail6x8r.fnt
  120. font 2   gal7x11r.fnt
  121. font 3   ser7x12r.fnt
  122. font 4   cour7x12b.fnt
  123. font 5   cour7x14r.fnt
  124. font 6   ser8x16r.fnt
  125. font 7   ser9x18r.fnt
  126. font 8   cour9x16b.fnt
  127. font 9   cmr9x16r.fnt
  128. font 10  cmr10x16b.fnt
  129. font 11  gal12x20r.fnt
  130. font 12  cmr14x25r.fnt
  131. font 13  cmr15x25r.fnt
  132. font 14  shadow38x40b.fnt
  133. font 15  dot1x1r.fnt
  134. window 0    0    80c    24c    3
  135. flags    nokill    background
  136. start setenv TERM mgr; mgrmode background
  137. window -1    -1    -1    -1    1
  138. flags    nokill    background
  139. start setenv TERM mgr; mgrmode background
  140. newwindow
  141. done
  142.  
  143. there was a small bug in mgr.prg as distributed, where it would not
  144. read entries in mgr.rc correctly. the patch to correct this problem is
  145. included in this distribution. i will try send a corrected mgr.prg upto 
  146. an archive as soon as i find a volunteer who is willing to receive it
  147. via mail from me, and send it up.
  148.  
  149. BUGS
  150. - support for multiple serial devices not there.
  151. - should support midi
  152. - mgrterm/rz/sz works fine at 19.2k on my setup (a 1040 with a FastTech
  153. processor -- highly recommended). you may need to either limit the
  154. baud rate, or restrict the sub-packet length in rz/sz (via -l option).
  155. if you are uploading to unix system, -l 128 is recommended above 1200
  156. baud. if you are downloading via a typical terminal server, use 
  157. a sub-packet length (i use sz -l 1024) on the unix end, to prevent the
  158. terminal server from timing out, while rz streams. when down-loading from
  159. GEnie, rz will take atleast one timeout to sync up. i dont know
  160. why this is so. after that, it streams just fine.
  161.  
  162. ACKNOWLEDGMENTS
  163.   the inner term loop is based on the simple mgrterm by
  164. david@doe.utoronto.ca (David Megginson). thanks david.
  165. of course none of this would be possible without eric smith. hats off to him
  166. for MiNT.
  167.  
  168. enjoy,
  169. --
  170. bang:   uunet!cadence!bammi            jwahar r. bammi
  171. domain: bammi@cadence.com
  172. GEnie:    J.Bammi
  173. CIS:    71515,155
  174.